LoadVars.addRequestHeader()

Доступность

Flash Player 6.

Синтаксис

my_lv.addRequestHeader(headerName:String, headerValue:String) : Void
my_lv.addRequestHeader(["headerName_1":String, "headerValue_1" ... "headerName_n", "headerValue_n":String]) : Void

Параметры

headerName Строка, отображающая имя HTTP заголовка.

headerValue Строка, отображающая данные, связанные с заголовком headerName.

Возвращает

Ничего.

Описание

Метод; добавляет или изменяет HTTP заголовки (такие как Content-Type или SOAPAction), отправляемые методом POST. В случае использования первого варианта синтаксиса, методу передается две строки: headerName и headerValue. Во втором случае передается массив значений, содержащий имена заголовков и их значения попарно.

Если один и тот же заголовок изменен несколько раз, каждый последующий вызов заменяет все изменения, сделанные предыдущими.

Следующие HTTP заголовки не могут быть добавлены или изменены при помощи данного метода: Accept-Ranges, Age, Allow, Allowed, Connection, Content-Length, Content-Location, Content-Range, ETag, Host, Last-Modified, Locations, Max-Forwards, Proxy-Authenticate, Proxy-Authorization, Public, Range, Retry-After, Server, TE, Trailer, Transfer-Encoding, Upgrade, URI, Vary, Via, Warning и WWW-Authenticate.

Пример

В следующем примере добавляется HTTP заголовок SOAPAction со значением Foo:

my_lv.addRequestHeader("SOAPAction", "'Foo'");

В следующем примере создается массив headers, содержащий два HTTP заголовка и связанных с ним значения. Массив передается в качестве параметра методу addRequestHeader().

var headers = ["Content-Type", "text/plain", "X-ClientAppVersion", "2.0"];
my_lv.addRequestHeader(headers);

В следующем примере создается объект LoadVars, которому добавляется заголовок FLASH-UUID. Заголовок содержит данные, которые могут быть использованы сервером.

var my_lv:LoadVars = new LoadVars();
my_lv.addRequestHeader("FLASH-UUID", "41472");
my_lv.name = "Mort";
my_lv.age = 26;
my_lv.send("http://flash-mx.com/mm/cgivars.cfm", "_blank", "POST");

См. также

XML.addRequestHeader()